Skip to main content

API Integration Specifications

Purpose: Document the payload schemas and API endpoints for integrating Odoo with the Security Stack.

1. Pulseway Integration​

Authentication: OAuth2 Bearer Token. Base URL: https://api.pulseway.com/v2

Incoming Webhook: System Registered (Upstream)​

Trigger: New device agent installed. Payload Schema:

{
  "EventType": "SystemRegistered",
  "SystemIdentifier": "String",
  "Name": "String",
  "Group": "String",
  "OS": "String",
  "CustomFields": {
      "Serial": "String"
  }
}

Outgoing API: Create Organization (Downstream)​

Trigger: Odoo Partner Created. Endpoint: POST /organizations Payload Schema:

{
  "Name": "String (Partner Name)",
  "Description": "Synced from Odoo",
  "Country": "String (Optional)",
  "State": "String (Optional)"
}

2. RocketCyber Integration​

Authentication: API Key. Base URL: https://api.rocketcyber.com/v2

Incoming Webhook: Incident Created​

Trigger: SOC creates an incident. Payload Schema:

{
  "EventType": "Notification",
  "source": "RocketCyber",
  "incident_id": "Integer",
  "severity": "Critical",
  "title": "Malware Detected",
  "description": "Full incident details...",
  "asset_identifier": "String (Matches Pulseway ID if linked)"
}

3. Bitdefender Integration​

Authentication: API Key. Base URL: https://cloud.gravityzone.bitdefender.com/api

(Payloads to be confirmed in Phase 2)